# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: Player{number}

# Used to describe your yaml. Useful if you have multiple files.
description: Default DOOM Eternal Template

game: DOOM Eternal
requires:
  version: 0.6.7 # Version of Archipelago required for this yaml to work as expected.

DOOM Eternal:
  ################
  # Game Options #
  ################
  progression_balancing:
    # A system that can move progression earlier, to try and prevent the player from getting stuck and bored early.
    # 
    # A lower setting means more getting stuck. A higher setting means less getting stuck.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 99
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-99: 0 # random value between 0 and 99
    disabled: 0 # equivalent to 0
    normal: 50 # equivalent to 50
    extreme: 0 # equivalent to 99

  accessibility:
    # Set rules for reachability of your items/locations.
    # 
    # **Full:** ensure everything can be reached and acquired.
    # 
    # **Minimal:** ensure what is needed to reach your goal can be acquired.
    full: 50
    minimal: 0

  death_link:
    # When you die, everyone who enabled death link dies. Of course, the reverse is true too.
    'false': 50
    'true': 0

  randomize_chainsaw:
    # Randomize the Chainsaw. If false, the Chainsaw will always be found at its
    # vanilla location in Hell on Earth.
    'false': 50
    'true': 0

  randomize_dash:
    # Shuffle the Dash pickup into the item pool.
    'false': 50
    'true': 0

  randomize_first_battery:
    # When enabled, the mandatory first Sentinel Battery is shuffled into the
    # item pool instead of being locked to its Exultia pickup.
    'false': 50
    'true': 0

  include_weapon_mastery_challenges:
    # Include the 13 Weapon Mastery Challenge locations.
    'false': 0
    'true': 50

  reveal_ap_locations_on_automap:
    # Start with the AP progression-item reveal capability on the Automap.
    'false': 50
    'true': 0

  starting_weapon:
    # Choose the weapon you start with. Random selects one eligible weapon when the seed is generated. That weapon belongs to your starting inventory.
    random_weapon: 0
    heavy_cannon: 0
    plasma_rifle: 0
    rocket_launcher: 0
    ballista: 0
    chaingun: 0
    combat_shotgun: 50
    super_shotgun: 0

  praetor_suit_upgrades_in_pool:
    # Number of individual Praetor Suit upgrades placed in the item pool.
    # 
    # ``Random`` is resolved from the seeded world RNG. Its bounded, middle-biased
    # range avoids both empty and nearly-complete upgrade sets while explicit
    # values remain available across the full catalog range.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 21
    6: 50
    random: 0 # equivalent to -1
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-21: 0 # random value between 0 and 21

  trap_percentage:
    # Percentage of filler padding replaced by enabled traps.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    10: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-100: 0 # random value between 0 and 100

  enabled_traps:
    # Trap types eligible for filler-padding replacement.
    ['Fuel Drain Trap', 'BFG Drain Trap', 'Tyrant Trap', 'Marauder Trap', 'Revenant Trap', 'Arachnotron Trap', 'Cueball Trap', 'Archvile Trap', 'Baron Trap', 'Dread Knight Trap', 'Carcass Trap', 'Ammo Drain Trap', 'Imp Trap', 'Hell Knight Trap']

  ###########################
  # Item & Location Options #
  ###########################
  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with the specified amount of these items. Example: "Bomb: 1"
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  exclude_locations:
    # Prevent these locations from having an important item.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []

  plando_items:
    # Generic items plando.
    []
